Saltar al contenido principal

Obtenga una lista de todas las plantillas

El punto final se utiliza para obtener una lista de todas las plantillas del sistema, incluidas las plantillas de vídeo, carrusel, imágenes, citas y memes. Este es un punto final paginado y, por lo tanto, recibirá una respuesta paginada.

URL de solicitud

  • https://brain.predis.ai/predis_api/v1/get_templates/

Parámetros de solicitud

NombreDescripciónTipoValor por defectoValores posiblesObligatorio
brand_idbrand_id sirve como identificador único de su marca. Usando brand_id, también tendrás acceso a tus plantillas personalizadas en la primera página.CordónNoneYOUR_BRAND_ID
media_typePara obtener plantillas de un tipo de medio específico.Cordónsingle_imagesingle_image, carousel, videoNo
post_typePara obtener plantillas de un tipo de publicación específico. Para meme y quotes post media_type debiera ser single_image.Cordóngenericgeneric, meme, quotesNo
aspect_ratioPara obtener plantillas de una relación de aspecto específica.Cordónallsquare, portrait, landscape, allNo
page_nIndique el número de página para recuperar plantillas de esa página en particular.Entero11, 2, 3...etcNo
items_nIndique el número deseado de plantillas para cada página.Entero101, 2, 3...etcNo

Ejemplo de respuesta exitosa

{
"templates": [{
"template_id": "...",
"media_type": "..."
}],
"total_pages": 50,
"errors": []
}

Ejemplo de respuesta de error

{
"errors": [{
"detail": "...",
"solution": "..."
}]
}

Códigos de respuesta

Código de estado HTTPCódigo de errorMensaje de usuarioSolución recomendada
429001Número máximo de solicitudes alcanzadoSe alcanzó el número máximo de solicitudes por hora. Se le ha limitado la velocidad. Espere un momento y vuelva a intentarlo.
400002Inválido brand_id proveaHas proporcionado un inválido brand_id. Por favor proporcione una válida brand_id e inténtalo de nuevo. Leer más aquí
400003Los números de página del número de artículos no son válidosAsegúrese de que el valor de page_n y items_n es un número entero
400004Previsto aspect_ratio no es apoyadoAsegúrese de que el valor de aspect_ratio El campo es compatible. Consulte los parámetros de solicitud en la tabla anterior para obtener más detalles.
400005El valor proporcionado para el media_type el campo no es válidoAsegúrese de que el valor sea uno de single_image, carousel or video
400006El valor proporcionado para el video_duration el campo no es válidoAsegúrese de que el valor sea short or long
400007El valor proporcionado para el post_type el campo no es válidoAsegúrese de que el valor sea generic, meme or quotes
400008El valor proporcionado para el post_type El campo no es válido para el dado. media_typeEl proporcionado post_type y media_type La combinación de publicaciones aún no es compatible. Consulte los parámetros de solicitud en la tabla anterior para obtener más detalles.

Limitación de la velocidad

Estándar API Se aplican límites de velocidad a este punto final. Lea más sobre los límites de tarifas aquí